home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 January / macformat-020.iso / Shareware City / Developers / Commander Sets / 4D Speech Pack / 4D Speech Pack.rsrc / TEXT_19439_†SP Speak String.txt < prev    next >
Encoding:
Text File  |  1994-09-14  |  1.6 KB  |  37 lines

  1. SP Speak String (voice; line) -> err
  2.  
  3. voice          string (63) specifys the voice you want to use.
  4. line            string (255) is a string (max. length 255) which contains the
  5.                                    text you want to be spoken.
  6. err             integer       returns the error which occured. 
  7.                                     A value of zero indicates no error occured. See 
  8.                                     below for a list of possible errors.
  9.  
  10. Reads out the string you pass, using the specified voice, without returning to 4D until the line has been spoken.
  11.  
  12.  
  13. The full string will be spoken and control will not return to 4D until the voice is finished. It is not possible to cancel. This function can still be used when the limit of speech channels opened by the SP Open Voice function has been reached.
  14. An error will be returned if there is already a voice being produced, by Speech Pack or by any other software on the computer.
  15.  
  16. Examples:
  17.   $err := SP Speak String ("*";"Look who is talking!")
  18.   $err := SP Speak String ("Marvin";$line)
  19.   $err := SP Speak String ("Marvin";[File 1]Name)
  20.  
  21. Possible errors:
  22.         0  No Error
  23.       -4  Speech Pack can not be used (Speech Mgr not available)
  24.     -50  Parameter error (inside external, not necessarily the
  25.             parameters you pass)
  26.   -108  Not enough memory to load voice into memory    
  27.   -205  Bad channel, speaker volume is too low or Speech Pack disabled
  28.   -241  Could not open another speech synthesizer channel
  29.   -242  Voice synthesizer is not ready
  30.   -244  Voice resource not found
  31.   -247  Input text bad
  32. -3000  Invalid SpeechChannel parameter, probably invalid reference
  33.             number
  34.  
  35.  
  36.  
  37.